home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / prgtools / mint / utilit~1 / flut39st.zoo / fileutils-3.9 / man / chmod.1 < prev    next >
Encoding:
Text File  |  1994-03-26  |  4.0 KB  |  129 lines
  1.  
  2.  
  3.  
  4. CHMOD(1L)                        CHMOD(1L)
  5.  
  6.  
  7. N✓NA✓AM✓ME✓E
  8.        chmod - change the access permissions of    files
  9.  
  10. S✓SY✓YN✓NO✓OP✓PS✓SI✓IS✓S
  11.        c✓ch✓hm✓mo✓od✓d   [-Rcfv]     [--recursive]     [--changes]   [--silent]
  12.        [--quiet] [--verbose] [--help] [--version] mode file...
  13.  
  14. D✓DE✓ES✓SC✓CR✓RI✓IP✓PT✓TI✓IO✓ON✓N
  15.        This manual page     documents  the     GNU  version  of  c✓ch✓hm✓mo✓od✓d.
  16.        c✓ch✓hm✓mo✓od✓d changes the permissions of    each given file    according
  17.        to _✓m_✓o_✓d_✓e,    which can be either a symbolic representation  of
  18.        changes    to  make, or an    octal number representing the bit
  19.        pattern for the new permissions.
  20.  
  21.        The     format      of     a     symbolic         mode      is
  22.        `[ugoa...][[+-=][rwxXstugo...]...][,...]'.   Multiple sym-
  23.        bolic operations    can be given, separated    by commas.
  24.  
  25.        A combination of    the letters `ugoa' controls which  users'
  26.        access  to  the file will be changed: the user who owns it
  27.        (u), other users    in the file's group (g), other users  not
  28.        in  the    file's    group  (o), or all users (a).  If none of
  29.        these are given,    the effect is as if `a'    were  given,  but
  30.        bits that are set in the    umask are not affected.
  31.  
  32.        The  operator  `+'  causes  the permissions selected to be
  33.        added to    the existing permissions of each file; `-' causes
  34.        them  to     be  removed;  and `=' causes them to be the only
  35.        permissions that    the file has.
  36.  
  37.        The letters `rwxXstugo' select the new permissions for the
  38.        affected     users:     read  (r), write (w), execute (or access
  39.        for directories)    (x), execute only if the file is a direc-
  40.        tory  or    already    has execute permission for some    user (X),
  41.        set user    or group ID on execution (s), save  program  text
  42.        on swap device (t), the permissions that    the user who owns
  43.        the file    currently has for it (u),  the    permissions  that
  44.        other  users  in    the file's group have for it (g), and the
  45.        permissions that    other users not    in the file's group  have
  46.        for it (o).
  47.  
  48.        A  numeric  mode     is  from one to four octal digits (0-7),
  49.        derived by adding up the    bits with values  4,  2,  and  1.
  50.        Any  omitted  digits are    assumed    to be leading zeros.  The
  51.        first digit selects the set user    ID (4) and set    group  ID
  52.        (2)  and    save text image    (1) attributes.     The second digit
  53.        selects permissions for the user    who owns the  file:  read
  54.        (4), write (2), and execute (1);    the third selects permis-
  55.        sions for other users in    the file's group, with    the  same
  56.        values;    and  the fourth    for other users    not in the file's
  57.        group, with the same values.
  58.  
  59.        c✓ch✓hm✓mo✓od✓d never changes the permissions of symbolic links; the
  60.        c✓ch✓hm✓mo✓od✓d  system  call cannot change their permissions.  This
  61.  
  62.  
  63.  
  64. FSF            GNU File Utilities            1
  65.  
  66.  
  67.  
  68. CHMOD(1L)                        CHMOD(1L)
  69.  
  70.  
  71.        is not a    problem    since the permissions of  symbolic  links
  72.        are never used.    However, for each symbolic link    listed on
  73.        the command line, c✓ch✓hm✓mo✓od✓d changes    the  permissions  of  the
  74.        pointed-to  file.   In  contrast,  c✓ch✓hm✓mo✓od✓d     ignores symbolic
  75.        links encountered during    recursive directory traversals.
  76.  
  77.    O✓OP✓PT✓TI✓IO✓ON✓NS✓S
  78.        _✓-_✓c_✓, _✓-_✓-_✓c_✓h_✓a_✓n_✓g_✓e_✓s
  79.           Verbosely    describe  only    files  whose  permissions
  80.           actually change.
  81.  
  82.        _✓-_✓f_✓, _✓-_✓-_✓s_✓i_✓l_✓e_✓n_✓t_✓, _✓-_✓-_✓q_✓u_✓i_✓e_✓t
  83.           Do  not print error messages about files whose per-
  84.           missions cannot be changed.
  85.  
  86.        _✓-_✓v_✓, _✓-_✓-_✓v_✓e_✓r_✓b_✓o_✓s_✓e
  87.           Verbosely    describe changed permissions.
  88.  
  89.        _✓-_✓R_✓, _✓-_✓-_✓r_✓e_✓c_✓u_✓r_✓s_✓i_✓v_✓e
  90.           Recursively change permissions of     directories  and
  91.           their contents.
  92.  
  93.        _✓-_✓-_✓h_✓e_✓l_✓p Print  a    usage message on standard output and exit
  94.           successfully.
  95.  
  96.        _✓-_✓-_✓v_✓e_✓r_✓s_✓i_✓o_✓n
  97.           Print version information    on standard  output  then
  98.           exit successfully.
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128. FSF            GNU File Utilities            2
  129.